Access Integration Services Using and Configuring Features Version 3.3

Configuring and Monitoring Thin Server Function

This chapter describes how to use the Thin Server Function (TSF) configuration and operating commands and includes the following sections:

"Accessing the TSF Configuration Environment"
"TSF Configuration Commands"
"Accessing the TSF Monitoring Environment"
"TSF Monitoring Commands"

Accessing the TSF Configuration Environment

Use the following procedure to access the TSF configuration process.

At the OPCON prompt, enter talk 6. (For more detail on this command, refer to "The OPCON Process and Commands" in Access Integration Services Software User's Guide.) For example:
```
    * talk 6
    Config>
 
```
After you enter the talk 6 command, the CONFIG prompt (Config>) displays on the terminal. If the prompt does not appear when you first enter configuration, press Return again.
At the CONFIG prompt, enter the feature tsf command to get to the Thin server config> prompt.

TSF Configuration Commands

To configure TSF, enter the commands at the Thin server config> prompt.

Table 60. TSF Configuration Command Summary

Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Add Adds master file server (RFS or NFS).
Delete Deletes master file server (RFS or NFS).
List Lists the thin server configuration.
Modify Modifies master file server (RFS or NFS).
Set Sets the thin server parameters.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Function
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Add	Adds master file server (RFS or NFS).
Delete	Deletes master file server (RFS or NFS).
List	Lists the thin server configuration.
Modify	Modifies master file server (RFS or NFS).
Set	Sets the thin server parameters.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add a master file server configuration.

If you select nfs as the master-file-server type, the Thin Server will use NFS to communicate with the master file server and synchronize files and NSs can communicate with the Thin Server using TFTP or NFS. If you select rfs as the master-server type, then the Thin Server will use RFS to communicate with the master file server and synchronize files and NSs can communicate with the Thin Server using TFTP or RFS.

Syntax:

add master-file-server: nfs-s390
: nfs-nt
: nfs-aix
: nfs-other
: rfs-as400

nfs-s390

Used when the TSF is connected to a S/390.

file server IP address

Valid Values: any valid IP address

Default Value: none

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added. Additional subdirectories may be specified if the TSF needs to cache files that are not in the default directories.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-nt

Used when the TSF is connected to Windows-NT.

file server IP address

Valid Values: any valid IP address

Default Value: none

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-aix

Used when the TSF is connected to AIX.

file server IP address

Valid Values: any valid IP address

Default Value: none

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

nfs-other

Used when you want to manually designate all of the subdirectories.

file server IP address

Valid Values: any valid IP address

Default Value: none

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

additional Include subdirectories

Specifies whether additional Included subdirectories are to be added.

Valid Values: yes or no

Default Value: yes

additional Include subdirectory path

Specifies the path of the Include subdirectory to be added.

Valid Values: a-z, A-Z, 0-9, ., _, --, /

Default Value: none

include all subdirectories under this directory

Specifies whether all nested subdirectories in the specified additional subdirectory path will be included.

Valid Values:

No
The TSF will pre-load all files in the specified directory.
Yes
The TSF will not pre-load any files in the specified directory. Instead the TSF will load files from the directory and any of its sub-directories as needed.

Default Value: no

rfs-as400

Used when the TSF is connected to an AS/400.

file server IP address

Valid Values: any valid IP address

Default Value: none

tftp packet timeout

Valid Values: 5 - 10 seconds

Default Value: 5

tftp maximum retry limit

Valid Values: 1 - 10

Default Value: 1

maximum segment size

Specifies the maximum packet segment size.

Valid Values: 512, 1024, 2048, 4096, 8192 (bytes)

Default Value: 8192

pre-load file name

Specifies the name and path of the pre-load file.

Valid Values: a-z, A-Z, 0-9, ., _, --, /Default Value: /QIBM/ProdData/OS400/NetStationRmtController/LoadList.file

Example: For NFS

Thin server config> add master-file-server nfs
 File Server IP address [0.0.0.0]? 10.22.55.94
 TFTP Packet Timeout in seconds (5 - 10) [5]?6
 TFTP Max Retry Limit (1 - 10) [1]? 7
 TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) [8192]? 512
 
Default Include Directories:
 
    Include Directory List Follows:
 
    Include
      all
    Subdirs?   Directory Names
    --------   -----------------------------------
       N       /hfs/usr/lpp/nstation/standard
       Y       /hfs/usr/lpp/nstation/standard/mods
       Y       /hfs/usr/lpp/nstation/standard/nls
       Y       /hfs/usr/lpp/nstation/standard/fonts
       Y       /hfs/usr/lpp/nstation/standard/java
       Y       /hfs/usr/lpp/nstation/standard/keyboards
       Y       /hfs/usr/lpp/nstation/standard/proms
       Y       /hfs/usr/lpp/nstation/standard/X11
       Y       /hfs/usr/lpp/nstation/standard/configs
       Y       /hfs/usr/lpp/nstation/standard/SysDef
       Y       /hfs/usr/lpp/nstation/standard/zoneinfo
   Do you want additional Include Subdirectories (Y)es (N)o? [y]
 
Include Subdirectory [   ]? /usr/lpp/nstation/standard/whatever
Include all subdirectories under this directory (Y)es or (N)o? [n]
 
Do you want additional Include Subdirectories (Y)es (N)o? []

Example: For RFS

Thin server config> add master-file-server rfs
 File Server IP address [0.0.0.0]? 01.01.01.98
 TFTP Packet Timeout in seconds (5-10) [5]? 6
 TFTP Max Retry Limit (1-10) [1]? 7
 TFTP Max Segment Size in bytes (valid values are 512, 1024, 2048, 4096, 8192) [8192]? 512
 
 Pre-Load File name
 [/QIBM/ProdData/OS400/NetStationRmtController/LoadList.file]?

Delete

Use the delete command to remove a master file server configuration.

Syntax:

delete master-file-server: nfs
: rfs

nfs: Used when any of the NFS master file servers is configured.
rfs: Used when the TSF is configured for the RFS master file server.

List

Use the list command to display the TSF configuration.

Syntax:

list all

Example:

Thin server config> list all
 
Thin Server Feature:
     Enabled
     Interval to refresh cache in day(s):  2
     Time of day (military time) to refresh cache: 0800
     Megabytes used for Thin Server RAM cache:  4
     Use Hard File:  YES
 
Master Thin Server list:
     Server IP Address: 9.37.111.12
     Server Protocol: NFS
     TFTP Packet Timeout in seconds:  10
     TFTP Retry Limit              :  6
     TFTP Max Segment Size in bytes:  512
 
 
     Initial directories setup for server type: NFS-AIX
 
  NFS Include Directory List Follows:
 
     Include
       all
     subdirs?    Directory Names
     --------    --------------------------------------------
 
        N        /usr/netstation
        Y        /usr/netstation/mods
        Y        /usr/netstation/nls
        Y        /usr/netstation/fonts
        Y        /usr/netstation/java
        Y        /usr/netstation/keyboards
        Y        /usr/netstation/proms
        Y        /usr/netstation/X11
        Y        /usr/netstation/configs
        Y        /usr/netstation/SysDef
        Y        /usr/netstation/zoneinfo

Modify

Use the modify command to modify a master file server configuration.

Syntax:

modify master-file-server: nfs
: rfs

nfs: Used when one of the NFS master file servers has been configured.
rfs: Used when the TSF is configured for the RFS master file server.

Example: For NFS

Thin server config> modify master-file-server nfs
 File Server IP address [         ]? 10.22.55.94
 TFTP Packet Timeout in seconds (5 - 10) [5 ]? 10
 TFTP Max Retry Limit (1 - 10) [1]? 6
 TFTP Max Segment Size in bytes valid values are 512, 1024, 2048, 4096,
 8192) [8192]? 1024
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard, (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]? 
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard/mods], (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]?
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard/nls], (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]? 
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard/fonts], (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]? 
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard/java], (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]? 
 
 Include subdirectory [/usr/lpp/tcpip/nstation/standard/keyboards], (Y)es or (N)o [Y]?
         Include all subdirectories under this directory (Y)es or (N)o [N]? 
 
 Do you want additional Include Subdirectories (Y)es or (N)o? n

Example: For RFS

Thin server config> modify master-file-server rfs
 File Server IP address [09.09.255.253 ]? 01.01.01.98
 TFTP Packet Timeout in seconds [5 ]? 10
 TFTP Retry Limit [5 ]? 6
 TFTP Max Segment Size in bytes [8192]? 512
 
 Pre-Load File name
 [/QIBM/ProdData/OS400/NetStationRmtController/LoadList.file]?

Set

Use the set command to set TSF configuration parameters.

Syntax:

set: mode
: interval-pre-load-list
: time-to-refresh-pre-load-list
: memory-cache
: hard-file

mode

Specifies the mode of the TSF.

Valid Values:

enable
A mode of enable means that the TSF is fully functional and will serve cached files to Network Stations.
disable
A mode of disable means that the TSF is not active and will not respond to any Network Stations. Network Stations should be configured to communicate directly to the server.
passthru
A mode of passthru is only valid when using RFS. Passthru will allow the Network Station to contact the TSF, but will always get files from the master file server.

Default Value:

interval-pre-load-list

Specifies the interval to refresh the pre-load list in days.

Valid Values: 00 - 365

Default Value: 01

time-to-refresh-pre-load-list

Specifies the time of day in military (24-hour time) to refresh cache.

Valid Values: 0001 - 2400

Default Value: 0100

memory-cache

Specifies the amount of memory in megabytes for Thin Server RAM cache. When using a hard file, this value should be chosen so as to balance the performance of TSF with other functions in the IBM 2212. When not using a hard file, this value should be large enough to hold all cached files. For more information, see "Configuration Recommendations".

Valid Values: 8 - 64 Megabytes

Default Value: 16

hard-file

Specifies whether to use the hard file.

Valid Values: yes or no

Default Value: yes

Example:

Thin server config> set mode passthru
This server feature (TSF) is passthru
Thin server config> set interval-pre-load-list
Interval to refresh the Pre-Load list in days (00-365) [01]? 1
Thin server config> set time-to-refresh-pre-load-list
Time of day to refresh cache in military time (0001-2400) [0100] 0800
Thin server config> set memory-cache
Amount of memory in megabytes for Thin Server RAM cache (8-64MB) [8]
Thin server config> set hard-file
Use the Hard File  (Y)ex N(o) [Y]? yes

Accessing the TSF Monitoring Environment

Use the following procedure to access the TSF monitoring commands. This process gives you access to the TSF monitoring process.

At the OPCON prompt, enter talk 5. (For more detail on this command, refer to The OPCON Process and Commands in the Access Integration Services Software User's Guide.) For example:
```
    * talk 5
    +
```
After you enter the talk 5 command, the GWCON prompt (+) displays on the terminal. If the prompt does not appear when you first enter configuration, press Return again.
At the + prompt, enter the f tsf command to get you to the Thin-Server> prompt.
Example:
```
    + f tsf
    Thin-Server>
```

TSF Monitoring Commands

This section describes the TSF monitoring commands.

Table 61. TSF Monitoring Command Summary

Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Delete Deletes a file from Thin Server feature file cache.
Flush Flushes the Thin Server feature file cache.
List Displays Thin Server settings and values.
Refresh Refreshes the cache.
Reset Resets counters.
Restart Restarts the Thin Server process.
Set Changes Thin Server feature settings.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Command	Function
? (Help)	Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Delete	Deletes a file from Thin Server feature file cache.
Flush	Flushes the Thin Server feature file cache.
List	Displays Thin Server settings and values.
Refresh	Refreshes the cache.
Reset	Resets counters.
Restart	Restarts the Thin Server process.
Set	Changes Thin Server feature settings.
Exit	Returns you to the previous command level. See "Exiting a Lower Level Environment".

Delete

Use the delete command to remove a file from the Thin Server feature file cache.

Syntax:

delete: filename

filename

Specifies the name of the file to be remove from the file cache.

Valid Values:

Default Value: none

Example:

Thin-Server> delete
Enter filename to delete from the File Cache: /ibm/prod/ns/5494.dat
Are you sure that you want to delete this file? (Y/ [N]): y
File successfully deleted

Flush

Use the flush command to flush the TSF memory and hard disk cache space. The flush command will erase all cached files. The Thin Server cache will be updated on the next refresh from the Master Server. Network Stations may experience delays until the refresh is completed.

Syntax:

flush

Example:

Thin-Server> flush
The FLUSH command will erase all cached files.
  The Thin Server cache will be updated on the next refresh
  from the Master Server.  Network Stations may experience
  delays until the refresh is completed.
Are you sure you really want to do this? (Y/ [N]: y
All Thin Server cached files have been flushed

List

Use the list command to display TSF parameter settings.

Syntax:

list: cached-files
: config
: file-access-counters
: file-refresh-counters
: pre-load-list
: tftp-counters
: ts-counters

Example:

Thin-Server> list cached-files
 
Cached
File Name     File Size  Time Stamp         Flags  Host File Name
------------  ---------  -----------------  -----  -----------------
00000026.DAT      2729   04/08/98 13:35:07   RYY   /QIBM/ProdData/OS400/Netstat
ionRmtController/Loadlist.file
00000002.DAT   2049220   09/16/97 08:55:39   RYU   /QIBM/PRODDATA/NETWORKSTATIO
N/KERNEL
                 10060   03/04/97 16:12:44   RY-   /QIBM/PRODDATA/NETWORKSTATIO
N/FONTS/PCF/MISC/7X14B.PCF
    List is Complete

The flags have the following meaning:

WhereFrom
- R = RFS Client
- N = NFS Client
- - = None
InTable
- - = Not in Table
- u (or m) = About to Update
- Y = In the Table
FileState
- - = Not on Disk
- D = Dirty
- A = Update Aborted
- u = About to Update
- U = Update in Progress
- Y = On the Disk and Available

Common combinations of the last two flags (all three flags shown for clarity) are:

RYY - good file
RuY - full refresh in progress, this file hasn't been verified yet
RYU - this file is being updated

Example: For RFS

Thin-Server> list config
Thin Server Configuration       
    Thin Server feature is:                             Enabled 
    Thin Server feature state is:                        Active, initializing file structure
    Interval to refresh Pre-Load List (#days):          1
    Time of day (Military) to refresh Pre-Load List:    01:00:00
    Memory (KB) currently using for RAM cache:          25600
    Maximum memory (KB) configured for RAM cache:       25600
    Currently using Hard File?:                         Yes 
    Hard File storage defined for Thin Server:          942752
    Hard File storage being used for Thin Server:       0
    Number of Files Cached:                             0
    Master Server IP address:                           9.37.177.61
    TFTP Packet Timeout Value:                          5
    TFTP Max Retries:                                   1
    TFTP Max Segment Size:                              8192
 
    Thin Server Sync Protocol:                          RFS
    Name of Pre-Load List file: 
        /QIBM/ProdData/OS400/NetstationRmtController/Loadlist.file
Thin Server>

Example: For NFS

Thin-Server> list config
 
Thin Server Configuration       
   Thin Server feature is:                          Enabled 
  Thin Server Feature state is:                     Active, initializing file structure
  Interval to refresh Pre-Load List (#days):       1
  Time of day (Military) to refresh Pre-Load List: 01:00:00
  Memory (KB) currently using for RAM cache:       25600
  Maximum memory (KB) configured for RAM cache:    25600
  Currently using Hard File?:                      Yes 
  Hard File storage defined for Thin Server:       915424
  Hard File storage being used for Thin Server:    27328
  Number of Files Cached:                          82
  Master Server IP address:                        9.37.181.47
  TFTP Packet Timeout Value:                       5
  TFTP Max Retries:                                1
  TFTP Max Segment Size:                           8192
 
  Thin Server Sync Protocol:                       NFS
  Include Directory List Follows:
 
  Include                                           
    all                                             
  Subdirs?   Directory Names                        
  --------   -----------------------------------    
     N       /usr/netstation
     Y       /usr/netstation/mods
     Y       /usr/netstation/nls
     Y       /usr/netstation/fonts
     Y       /usr/netstation/java
     Y       /usr/netstation/keyboards
     Y       /usr/netstation/proms
     Y       /usr/netstation/X11
     Y       /usr/netstation/configs
     Y       /usr/netstation/SysDef
     Y       /usr/netstation/zoneinfo
Thin Server>

Example:

Thin-Server> list file-access-counters
 
Disk Statistics/Counters:
    Number of files currently open:                20
    Number of Total File Opens:                    23
    Number of Open Fails when File is Locked:       1
    Number of Read misses - Version Mismatch:       4
    Number of Read misses - File Not Present:       3
    Number of Write misses - Hard File Full:        4

Example:

Thin-Server> list file-refresh-counters
 
File Refresh Statistics/Counters 
    Number of Files Updated during last refresh:       0
    Number of Update Failures during last refresh:     0
     Number of Refreshes:                               0
    Number of Refresh Failures:                        1
    Number of Files Refreshed:                         30
    Date/Time of Last File Update:                     has not occurred since last reset
    Date/Time of Last File Download:                   has not occurred since last reset 
 
Thin Server>

Example:

Thin-Server> list pre-load-list
 <display of pre-load list raw file>
List of Pre-Load List File is Complete

Example:

Thin-Server> list tftp-counters
 
TFTP Statistics/Counters
    Number of Total TFTP Clients:                             3
    Number of Current TFTP Clients:                           2
    Number of Files Served:                                  22
    Number of Files Served by Master Server:                 22

Example: For RFS

Thin-Server> list ts-counters
 
Thin Server Statistics/Counters    
    Relay to Master File Server:                            Available
    Number of Total RFS Clients:                            0
    Number of Current RFS Clients:                          0
    Number of Files Served:                                 0
    Number of Files Served by Master Server:                0
    Number of NS Port Mapper socket accepts:                0
    Number of NS Port Mapper sockets currently active/open: 0
    Number of NS Server socket accepts:                     0
    Number of NS 8473 sockets currently active/open:        0
    Number of NS Login sock accepts:                        0
    Number of NS 8476 sockets currently active/open:        0
    Number of RFS writes to a Thin Server cached file:      0
Thin Server>

Example: For NFS

Thin-Server> list ts-counters
 
Thin Server Statistics/Counters
    Number of NFS Server Reads:                              13
    Number of NFS Server Read Directories:                    8
    Number of Unsupported NFS Requests:                       2
    Number of total NFS Mounts:                              22
    Number of current NFS Mounts:                             7
    Number of total NFS clients:                             15
    Number of current NFS Clients:                            4

Refresh

Use the refresh command to force a refresh of the cache.

Syntax:

refresh

Example:

Thin-Server> refresh
 
Force a refresh of the cache ? (Y/ [N]): y
 
Thin Server cache has been refreshed

Reset

Use the reset command to dynamically reset counters.

Syntax:

reset: all
: file-access-counters
: file-refresh
: tftp-counters
: ts-counters

Example:

Thin-Server> reset all
 
All Thin Server feature counters have been reset

Restart

Use the restart command to restart the TSF process.

Syntax:

restart

Example:

Thin-Server> restart
 
Restart Thin Server? (Y/ [N]): y
 
Thin Server has been restarted

Set

Use the set command to set the TSF caching mode.

Syntax:

set: mode

mode

Specifies the mode of the TSF. See "Set".

Valid Values:

enable
disable
passthru

Example:

Thin-Server> set mode ?
 
DISABLED
ENABLED
PASSTHRU
 
Thin-Server> set mode disable
 
Thin Server caching is now disabled

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]